home *** CD-ROM | disk | FTP | other *** search
/ Dr. Windows 3 / dr win3.zip / dr win3 / PVDRIVER / MACFONTX.ZIP / UNSTUFIT.ZIP / UNSTUFIT.DOC next >
Text File  |  1988-02-12  |  23KB  |  666 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.              ----------------------------------
  21.               unStufit: for the IBM PC
  22.              ----------------------------------
  23.                 STUFFIT file unpacker
  24.              ----------------------------------
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.     unStufit is distributed freely and may be copied by anyone for
  33.     any number of machines.  The author considers unStufit to be
  34.     "shareware" or "freeware".  unStufit is a part of the shareware
  35.     package PC-VCO.  If you have subscribed to PC-VCO, unStufit is
  36.     released for your use.    If you wish to use unStufit without
  37.     subscription to PC-VCO, please support its development and main-
  38.     tenance with a subscription of 10.00 dollars.  The author may be
  39.     reached at:
  40.  
  41.              CABER Software
  42.              R. (Scott) McGinnis
  43.              P.O. Box 3607 Mdse Mart
  44.              Chicago, IL 60654-0607
  45.  
  46.              PLINK id: TARTAN
  47.  
  48.  
  49.  
  50.  
  51.                                 Version 1.0: 880211
  52.                                 R.McGinnis; Chicago
  53.  
  54. unStufit: STUFFIT file extractor
  55. Version 1.0: 880211
  56.  
  57.  
  58.                  Table of Contents
  59.                  -----------------
  60.  
  61.  
  62.  
  63. I.    Introduction  ................................................. page  1
  64.  
  65. II.    Running the program  .......................................... page  3
  66.  
  67. III.    unStufit Command Summary ...................................... page  4
  68.  
  69. IV.    unStufit Switches ............................................. page  5
  70.  
  71. V.    VCOLIB usage .................................................. page  6
  72.  
  73. VI.    Batch extraction .............................................. page  7
  74.  
  75. VII.    Program Requirements .......................................... page  7
  76.  
  77. VIII.    Program and Author Information    ............................... page  8
  78.  
  79.  
  80.  
  81.  
  82.                 Appendices
  83.                 ----------
  84.  
  85.  
  86. A.    MacBinary Header .............................................. page  9
  87.  
  88. B.    STUFFIT File structure ........................................ page 10
  89.  
  90. C.    STUFFIT Archive Header ........................................ page 11
  91.  
  92. D.    STUFFIT Subfile Header ........................................ page 12
  93.  
  94. E.    unStufit Error messages ....................................... page 13
  95.  
  96.  
  97.  
  98.  
  99. unStufit: STUFFIT file extractor                    Page  1
  100. Version 1.0: 880211
  101.  
  102.  
  103. I.    Introduction
  104.  
  105.  
  106.     unStufit for the IBM PC is a utility that extracts files packed
  107.     together on a MacIntosh computer with the STUFFIT utility.  STUFFIT
  108.     on the MacIntosh will pack multiple files together (optionally
  109.     compressing and encoding them) into one file.  unStufit on the IBM
  110.     PC allows the extraction of individual files from the STUFFIT
  111.     envelope.  Many files maintained as '.SIT' (the usual STUFFIT
  112.     extension) on Mac BBS's, Clubs, and SIG's are now accessible to
  113.     users of the IBM PC.
  114.  
  115.  
  116.     STUFFIT was developed and has been extended by Raymond Lau.  STUFFIT
  117.     (through version 1.20) stored files together, with non-compression
  118.     and 3 optional types of data compression.  STUFFIT is available as
  119.     shareware.
  120.  
  121.  
  122.     unStufit is compatible with STUFFIT.  unStufit was developed to
  123.     support the shareware package PC-VCO for the IBM PC.  Face files
  124.     created on MacIntosh computers are frequently packed together on the
  125.     various boards:  PLINK, CIS, Delphi, and GEnie.  Now packed face
  126.     files are available to PC-VCO users.  A packed file may be
  127.     downloaded to an IBM PC and unStufit used to extract individual face
  128.     files.
  129.  
  130.  
  131.  
  132.     unStufit may be copied freely and distributed to anyone for any
  133.     number of machines.  The author considers this to be "shareware" or
  134.     "freeware" unStufit is a part of the shareware package PC-VCO.  If
  135.     you have sub- scribed to PC-VCO, unStufit is released for your use.
  136.     If you wish to use unStufit without subscription to PC-VCO, a
  137.     contribution is asked.    unStufit (and PC-VCO/unStufit) will be
  138.     extended and enhanced if response warrants.
  139.  
  140.  
  141. unStufit: STUFFIT file extractor                    Page  2
  142. Version 1.0: 880211
  143.  
  144.  
  145. I.    Introduction (continued)
  146.  
  147.  
  148.     What is PC-VCO, by-the-way?
  149.  
  150.     PC-VCO is a communications program for the IBM PC with two sides.
  151.     On the one hand, it provides standard comm program functions:  a
  152.     dialing directory, macros, disc logging, XMODEM and ASCII file
  153.     transfer, and so on.  However, used with network conferencing
  154.     services such as People/Link's PARTY, CompuServe's CB and Delphi's
  155.     conference area, PC-VCO provides a way to 'see' and 'hear' people
  156.     talking.
  157.  
  158.  
  159.     The idea for PC-VCO was derived from the VCO system, and its
  160.     predecessor VMCO, developed for the MacIntosh computer.  The VCO
  161.     programs (PC and MacIntosh) allow you to see the people you
  162.     communicate with on-line, using the graphic capabilities of the
  163.     personal computer and to hear conversation with speech synthesis.
  164.  
  165.  
  166.  
  167.     VCO was originally developed by Harry Chesley.    It was followed by
  168.     VMCO (which is CIS specific), written by Bob Perez independant to
  169.     the development of VCO.  The current (MacIntosh) version of VCO is
  170.     almost an exact duplicate of Harry Chesley's original - the original
  171.     source code was converted by Mike Cohen and made to accept multiple
  172.     service formats.  [Note:  Mike Cohen's VCO uses VMCO formated files.
  173.     Harry Chesley's VCO files differ.  VCOLIB can accomodate either.
  174.     PC-VCO in VCO mode can talk to either, according to your choice.]
  175.  
  176.  
  177.     The MacIntosh VCO allows the user to see the people talking on-line
  178.     through graphic Icons.    The Icons are provided to the VCO program as
  179.     'Resource files' and are built using a 'Resource Editor'.  Each VCO
  180.     user must have a resource file for every potential other speaker.
  181.     Charlie Brown and Snoopy Icons are used if no 'Faces' are available.
  182.     A range of expressions, from 'normal' to bored to surprised make VCO
  183.     conferences lively.  Each participant controls the expression
  184.     displayed to all other participants.
  185.  
  186.  
  187.     On most large systems, the face files for 20 or more people have
  188.     been packed (and compressed) together with the shareware product
  189.     STUFFIT.  The files will be found in the library areas with the
  190.     extension of '.SIT'.  And thus unStufit for the IBM PC !
  191.  
  192.  
  193. unStufit: STUFFIT file extractor                     Page 3
  194. Version 1.0:  880211
  195.  
  196.  
  197. II.    Running the program
  198.  
  199.  
  200.     unStufit is invoked at the DOS prompt with the command:
  201.  
  202.     ------------------------------------------------------
  203.     "d>" unStufit <option>
  204.  
  205.     Where "d>" is the DOS prompt, and
  206.  
  207.           <option> is: (<switch> or <cmd> <SIT-File> (<parm> (,<parm> ...)))
  208.  
  209.           where <switch>   is one of the following: /+, /-, /B, /D, /R
  210.             <parm>     is a subfile name,
  211.             <SIT-file> is the STUFFIT file name to be used,
  212.           and <cmd>        is one of the following: E,X,L,V
  213.  
  214.     Note: Specifying no commands at all will provide an abbreviated
  215.           HELP display summarizing available commands.
  216.     ------------------------------------------------------
  217.  
  218.     unStufit commands and switches are summarized on the next pages.
  219.  
  220.  
  221. unStufit: STUFFIT file extractor                     Page 4
  222. Version 1.0: 880211
  223.  
  224.  
  225. III.    unStufit Command Summary.
  226.  
  227.  
  228.     Command    Parameter Description
  229.     ---------  --------- --------------------------------------------------
  230.     (E)xtract  subfile   Extract the specified subfile.  Subfile names are
  231.            name      listed with the 'L' or 'V' commands.  Subfile names
  232.                  are up to 63 bytes in length, and may not contain
  233.                  a comma or a semi-colon.  Case is not significant.
  234.  
  235.     (X)tract   subfile   Extract the specified subfile.  This is simply a
  236.            name      synonym for the 'E' command discussed above for
  237.                  those of us who spell phonetically.
  238.  
  239.     (L)ist             List the subfiles of the specified SIT file.  If
  240.                  a parameter is given it will be ignored.  The
  241.                  list command gives the following information:
  242.  
  243.                  Subfile name (1-63 characters in length)
  244.                  File Type (4 characters)
  245.                  File creator (4 characters)
  246.                  Compression.  Compression types are:
  247.  
  248.                 0 - non-compression
  249.                 1 - repeat character compression (RLE)
  250.                 2 - dynamic Lempel-Ziv,Weiss compression
  251.                 3 - Huffman compression
  252.  
  253.  
  254.     (V)erbose         List the subfiles of the specified SIT file.  If a
  255.                  parameter is given it will be ignored.  The verbose
  256.                  list gives the information above and th